home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 4 / Info_Mac IV CD-ROM (Pacific HiTech Inc.)(August 1994).iso / Text Processing / Easy View 2.44 ƒ / Easy View Notes < prev   
Text File  |  1994-03-06  |  31KB  |  576 lines

  1. Rather than opening this text file, you should directly open the view file "Easy View - Read Me" in order to appreciate the program.
  2.  
  3. Views
  4. =====
  5. A view is a collection of text files, combined for easy viewing. The file contents are displayed in two levels, called chapters and sections in these notes. Every view has at least one chapter, each containing one or more sections. Views can be created, opened, and modified within Easy View. Simple printing of sections is supported.
  6.  
  7. Once a view is open, the left pane shows the chapters and the right pane shows the sections in the view. The current chapter and the current section are highlighted in the respective lists. The name of the open file is shown at the bottom of the window. More information about the open file will be displayed if the mouse is clicked on the file name.
  8.  
  9. Easy View is strictly a browser: it has no ability to modify files in any way. However, as a convenience, a small button is placed to the left of file name, which will open the file using the editor of your choice, when pressed. This action is equivalent to opening the text file in Finder.
  10.  
  11. This view, "Easy View - Read Me", combines two text files: "Easy View Introduction" and "Easy View Notes", as indicated in the lower-left corner.
  12.  
  13. Format
  14. ------
  15. The format of a view is just a convention that defines the chapters and sections contained in the text files. It is, in general, indicated by separation lines that are made up of identical characters, like hyphens or asterisks. The formats that are currently recognized by Easy View are explained below:
  16.  
  17. **Plain:** This is in fact "no format at all". The whole file becomes a single section. The only chapter and section will carry the name of the file.
  18.  
  19. **setext:** The structure-enhanced text was defined _primarily_ to be as unobtrusively marked-up as possible. Lines of hyphens and equal-signs _underline_ both visually and logically the different "weight" of the sections and chapters that they denote. The apparent length  of the labels and their separators must be the same. (Weekly TidBITS issues and this file are examples of setext format.) 
  20.  
  21. **Digest:** This is basically for e-mail digests, like Info-Mac or Simulation Digest. The chapters correspond to different digests, and the sections to the articles. The names for the chapters and the sections are found in the digest itself, using a set of configuration strings. Similar digest formats are configurable.
  22.  
  23. **Mail:** Various collections from different e-mail systems are supported. The configurable string indicates the separation of mail items in the file. This format has the limitation of only one chapter per file, and the file name is used as the name of the corresponding chapter. Sample views include Internet mail, Rice Notebook, and CompuServe Navigator formats. Other formats can be configured easily.
  24.  
  25. **Dictionary:** The file contains a listing of words along with their explanations, in alphabetical order. Each line is a section, the name is the first word of the line. Chapters correspond to the letters of alphabet, combining all words starting with a given letter.
  26.  
  27. Caution: Files of different formats can be mixed in a single view. However, it is strongly recommended that a single format is used throughout the view.
  28.  
  29. Two formats, _Simple_ and _Starred_, are not supported any more. Although their parsers are retained in EV 2.4, they may be removed in future versions. The users of these formats are urged to convert their existing documents to setext, using the "Save setext" command. This will result in a single setext file that can be divided into smaller parts manually by the user.
  30.  
  31. New view
  32. --------
  33. When the user selects "New…" from the File menu, a standard file dialog is presented, and the user makes an empty view, in a folder of his choice. Untitled views are never created, because the folder  for each view must be known, within which the files will reside.
  34.  
  35. When the empty view appears, it is ready for modifications.
  36.  
  37. Modifying a view
  38. ----------------
  39. The current version allows only inclusion of text files into the active view and their removal from it. Reordering of files is not implemented.
  40.  
  41. Three ways of modification is possible:
  42. * "Include Text" command
  43. * "Modify View" command
  44. * "Auto Modification" options in the Preferences
  45.  
  46. New users should use the last option, which works implicitly, without the need for an explicit command.
  47.  
  48.   Include Text
  49. --------------
  50. "Include Text…" command brings the standard file selection dialog, with only the text files being displayed. The selected file will be included in the active view.
  51.  
  52. Under System 6, the included files _must_ be in the folder of the view. Under System 7, this requirement is released with the use of aliases. The included file can be anywhere, provided that an alias can be made in the current folder.
  53.  
  54. Also under System 7, text files can be dragged into the application in Finder. The effect is the same as doing "Include Text…" command and selecting the file(s).
  55.  
  56.   Modify View
  57. -------------
  58. "Modify View…" command can be used on an open view. It presents the modification dialog with which files are added into or removed from the view. The first action should be making sure that the proper format appears in the pop-up menu. 
  59.  
  60. The file list on the left-hand side shows all the text files in the current folder, not included in the view. They can be added one by one with the ">" button (or the Return key), or all at once with the ">>>" button. It is recommended that a single file is tried first, and then ">>>" is used after the format turns out to be correct.
  61.  
  62. The files that are selected will be analyzed one at a time. This process may be terminated by pressing the mouse key or <command><period> as usual. This results in the last added file being removed.
  63.  
  64. It is also possible to remove files from the view by the "<" or "<<<" buttons. The user may select a file on the right-hand side for removal. All the chapters in the selected file will be removed _from the view_, not from the disk. (This is not a "delete" command.) 
  65.  
  66. The modification process marks the view "changed", a state which will be cleared by "Save" or "Revert" commands. If "Auto Save" option is checked, the view is immediately saved upon the exit from the dialog. In this case, Save and Revert operations will never be possible.
  67.  
  68. It should be emphasized that the text files are _never_ modified by this process.
  69.  
  70.   Auto Modification
  71. -------------------
  72. One of the most useful user options, this makes the modification process mostly transparent to the user. Three types of auto-modification are supported:
  73.  
  74. **Auto-modify view** 
  75. The modification date of the text file will be checked and the view will be modified if necessary. This check will be done on _every_ read operation.
  76.  
  77. **Include all files in the folder** 
  78. The view file under consideration is assumed to be alone in a private folder, with all the text files it combines. Whenever a new file enters the folder, dragged by the user or saved by another application, it is automatically added to the view. The current format is used in the process. 
  79.  
  80. **Remove files not found** 
  81. If a file is deleted or otherwise moved out of the folder, it is immediately removed from the view. 
  82.  
  83. For the last two cases, the directory will only be checked when a view is activated in the front. The views at the back are never affected.
  84.  
  85. The sample views are distributed in their own folders with "Include all files" option checked. Thus, the user simply drags the text files into their folders, and the views are modified automatically.
  86.  
  87. Disk vs. memory
  88. ---------------
  89. The view data contains only names and pointers to sections. Thus, it is stored always in the memory when a view is opened. The files, however, can be arbitrarily large. Only one file is open (read-only) at a given time and only one section is read into the memory. Because of TextEdit restrictions, the _displayed_ portion of a given section cannot exceed 32K bytes. Thus, longer sections are divided into chunks not exceeding this limit.
  90.  
  91. During the modification of the view, the whole file is read into the memory (if possible) for fast processing. This may impose a practical limit on the individual files. If failure occurs in "Modify…" command, try increasing the memory allocated to the application, or dividing the larger files into smaller parts. 
  92.  
  93. Easy View will work within a Finder partition of as little as 300K, but only very small files can be added in that case. (Unless System 7 can allocate the required amount of temporary memory)
  94.  
  95. The number of sections in a view is limited by 32K, practically unlimited for most needs. The number of chapters cannot exceed 1480.
  96.  
  97. The size of the view can be calculated as follows:
  98.        22 bytes per file
  99.        14 bytes per chapter
  100.        10 bytes per section
  101. Add to this, the total length of all file, chapter, and section names, and about 500 bytes of overhead.
  102.  
  103. Modified files
  104. --------------
  105. If some files in a view are modified outside the application, the appearance within Easy View will be damaged. In this version, there are two ways to correct the appearance: remove the file in the Modify dialog and add it again, or close the view and make a new view with the same name. In both cases, the preferences will be retained.
  106.  
  107. If some files in a view are moved, renamed, or deleted, Easy View has no way of locating them. The view itself can be renamed safely. The view can be moved, provided that all its files are also moved to the same folder. An open view should not be moved or renamed.
  108.  
  109. TidBITS & Info-Mac
  110. ------------------
  111. Two folders are included along with Easy View: one for TidBITS and one for Info-Mac archives. These folders can be freely put elsewhere on the disk. Once a file is downloaded, it should be put into the respective folder. The file will to be added _automatically_ into the view. These two types of files require no modification after downloading, the e-mail headers will be ignored. 
  112.  
  113. Caution: if you are downloading files, make sure that you do not activate the view before the file transfer is complete. Otherwise, Easy View will work on incomplete files. 
  114.  
  115. The views supplied with Easy View have the correct settings, as explained above in "Auto Modification" section. You may use the Preferences dialog to change the settings.
  116.  
  117.  
  118. Browsing
  119. ========
  120. Easy View opens the files in the view in a read-only state, with no intention of modifying them. Thus, the usual editing commands Cut, Paste, and Clear are not available. The only allowed editing operation is Copy command, which puts the selected text into the clipboard. The usual Copy operation and the text entry in the dialog boxes are undoable. 
  121.  
  122. Two ways of clipping text are supported: The user may add any selected text or the current section into a text file. Alternatively, all the occurrences of a search string can be extracted by a single command. Both of these operations create new files by default, existing files may be used optionally. Clipping and extracting to text files are not undoable.
  123.  
  124. Copy and Clip
  125. -------------
  126. These two commands work on the current selection, if any. If there is no selection, the complete section is to be copied or clipped, without explicitly selecting the text. This is equivalent to "Select All", then "Copy/Clip", and then restoring the old selection.
  127.  
  128. As another convenience to the user, "Open Clip File…" command opens an output file for further clipping operations. When used, subsequent clip operations will write the selected text or the whole section into that file. All clipping goes to that file until the program termination or being closed by the user.
  129.  
  130. The default file selection routine makes a new text file. If the option or shift keys are pressed when the mouse is released on the menu, an existing text file will be opened in Append mode. (cf. "Extract to…")
  131.  
  132. Search
  133. ------
  134. Searches may be undertaken from the current position in the active view until the last file in the view or from the "top of the view" starting with the first file in it.  Optionally one additional selector can also be used, chosen with the Filter popup menu in the dialog. The filter labels are somewhat cryptic but mean this:
  135.  
  136. Three filters are used for configurable searching:
  137. * E —> e :  ignore case
  138. * ê —> e :  ignore accents
  139. * É —> e :  ignore both
  140. More filters can be defined for other languages using Easy Convert, another freeware by the author.
  141.  
  142. As a non-standard feature, each view may have its own search string. This turns out to be rather useful in many cases, especially when different languages or scripts are in use. 
  143.  
  144. Searching may be terminated by pressing <command><period> or the mouse key as usual.
  145.  
  146. Extract
  147. -------
  148. All the occurrences of the current search string will be written to a text file. The default behavior is to extract the line of occurrence along with the chapter name. Optionally, the whole section may be extracted. With setext and digest formats, the resulting file will also have the correct section separators.
  149.  
  150. The default file selection routine makes a new text file. If the option or shift keys are pressed when the mouse is released on the menu, an existing text file will be opened in Append mode. (cf. "Clip to…")
  151.  
  152. Extracting may be terminated by pressing <command><period> or the mouse key as usual.
  153.  
  154. Movable Modal Dialogs
  155. ---------------------
  156. There are five dialogs in Easy View, all having the same "non-standard" behavior: Modify, Preferences, Configuration, Find, and Style dialogs.
  157.  
  158. These dialogs behave like the Movable Modal Dialogs of System 7. The same behavior will be observed even in the earlier systems.
  159.  
  160. When one of these dialogs is active, switching to another application is possible. Edit menu will be active, only if there is an editable item. Escape key and <command><period> are equivalent to Cancel or Done buttons, all dismissing the dialog properly.
  161.  
  162. Printing and Editing
  163. --------------------
  164. Printing is supported only when styles are off. Only the current section will be printed. "Print One" allows standard printing without the dialog.
  165.  
  166. Easy View is an application strictly for browsing. Text files are opened read-only, with no intent to modify them. However, under System 7, an Apple event could be sent to the Finder to open the current file, from the menu or by pressing the "E" button at the lower left corner of the window. The effect is the same as opening the file in Finder.
  167.  
  168. Windows
  169. -------
  170. EV windows can be hidden using the last menu. The effect is similar to closing the window. View name for hidden windows will appear in the menu in italic type face. Such views are retained in memory, but not displayed.
  171.  
  172. Clipboard is always the first window.
  173.  
  174. "Stack Windows" command will arrange the visible windows, except the clipboard, in the order of opening. Only the position will be changed, not the window size.
  175.  
  176.  
  177. Navigation
  178. ==========
  179. Five ways of navigation are available:
  180.  
  181. * Mouse (this works as expected, so it needs no further explanation)
  182.  
  183. * "Go" menu
  184.  
  185. * Numeric keypad
  186.  
  187. * Keyboard
  188.  
  189. * Special keys
  190.  
  191. "Go" menu
  192. ---------
  193. The text is displayed in three levels: chapters, sections, pages. Each of these levels has a vertical scroll bar. "Go" menu provides a quick way to go to the extremes of the scroll bars.
  194.  
  195. For those who prefer the keyboard shortcuts, almost all the items in this menu have numeric command key equivalents, making the keypad handy for navigation.
  196.  
  197. Numeric keypad
  198. --------------
  199. The numeric keypad can be used for scrolling the two lists or the text itself. Without the command key, 7-8-9 row works as "Scroll forward" and 1-2-3 row as "Scroll backward". The leftmost keys scroll chapters, the middle keys scroll sections, and the rightmost keys scroll pages.
  200.  
  201. With the command key, the same sets of keys have different functions, as explained in the "Go" menu: 7-8-9 row works as "First ..." and 1-2-3 row as "Last ...".
  202.  
  203. These keys never cross the boundaries of the chapters and sections.
  204.  
  205. 0 (zero) key displays the previous position, quite useful after a Find command or when a wrong key is pressed by mistake.
  206.  
  207. 4 and 6 keys move Backward/Forward in the history stack, which contains the last 15 displayed positions.
  208.  
  209. 5 key will display the last bookmark, if any.
  210.  
  211. The last position and the bookmark are saved along with the preferences, but not the history stack.
  212.  
  213. Keyboard
  214. --------
  215. Since this is a browsing utility rather than an editor, the keyboard is available for entering commands. A few keys have special meanings:
  216.  
  217.   Space  Continue forward
  218.     b    Continue backward
  219.     t    Scroll to first page (same as "First Page" command)
  220.     n    Next section (same as down arrow)
  221.     p    Previous section (same as up arrow)
  222.  
  223. These keys behave similar to the "rn" of unix. With the exception of "t", they may cross the chapter and section boundaries, if required. Thus, the Space key is very convenient for reading the file in a sequential fashion, using "b" or "n" once in a while.
  224.  
  225. With the command key, these keys either change their meaning completely or don't do anything. In that case, they become shortcuts for menu selection, as indicated on the respective menus.
  226.  
  227. Special keys
  228. ------------
  229. Up and down arrows change the current section. These keys may cross the chapter boundaries, if required. With the option key, they change the current chapter.
  230.  
  231. Left and right arrows change the current chapter. With the option key, they move Backward/Forward in the history stack, similar to 4/6 keys.
  232.  
  233. PgUp and PgDn keys scroll page up and down in the current section. With the command key, they display first and last pages. (Equivalent to 9/3 keys)
  234.  
  235. Home and End keys display first and last pages, respectively. With the command key, they display first and last chapters.
  236.  
  237. Browsing shortcuts
  238. ------------------
  239. Navigate among the sections in a view by selecting with the mouse, by _single-clicking_ on the chapter titles in the left pane or the section names at right. Alternatively, use commands in "Go" menu  or the following keyboard keys:
  240.  
  241. >      Key    Function
  242. >     ====== ========================+
  243. >      Left: prev Chapter            |
  244. >        Up: prev section            |
  245. >      Down: NEXT section            |
  246. >     Right: NEXT Chapter            |
  247. >     ====== ------------------------+
  248. >         t: TOP  of current section |
  249. >         b: prev page/section       |
  250. >     space: NEXT page/section       |
  251. >         p: prev section            |
  252. >         n: NEXT section            |
  253. >     ====== ========================+
  254.  
  255. (This section was suggested by Ian Feldman)
  256.  
  257. Keypad Summary
  258. --------------
  259. Without the command key:
  260. >                 +----------+----------+----------+
  261. > Scroll backward | Chapter  | Section  |   Page   |
  262. >                 +----------+----------+----------+
  263. > History         | Forward  | Bookmark | Backward |
  264. >                 +----------+----------+----------+
  265. > Scroll forward  | Chapter  | Section  |   Page   |
  266. >                 +----------+----------+----------+
  267. >                 |    Last position    |  (None)  |
  268. >                 +----------+----------+----------+
  269.  
  270. With the command key:
  271. >                 +----------+----------+----------+
  272. >    First ...    | Chapter  | Section  |   Page   |
  273. >                 +----------+----------+----------+
  274. >                 |  (None)  | Bookmark |  (None)  |
  275. >                 +----------+----------+----------+
  276. >    Last ...     | Chapter  | Section  |   Page   |
  277. >                 +----------+----------+----------+
  278. >                 |    Last position    |  (None)  |
  279. >                 +----------+----------+----------+
  280.  
  281. (This section was suggested by Ian Feldman)
  282.  
  283.  
  284. Preferences
  285. ===========
  286. Easy View handles the user options in two categories: view preferences are saved with the view, default preferences are written into the System Preferences folder.
  287.  
  288. View preferences
  289. ----------------
  290. For each view, the information indicated below will be stored. This information will be written into the resource fork when the view is saved or closed, only if the user has modified the current values. This information will also be written when they are changed by the Preferences dialog.
  291.  
  292. * A set of options in the form of checkboxes (see the next section)
  293. * File format (Pop-up menu)
  294. * Signature for "Clip to…" and "Extract to…" files
  295.   ("MSWD" for MS Word, "NISI" for Nisus, etc)
  296. * Vertical spacing in pixels (used only in styled text)
  297.  
  298. Options in the Prefs Dialog
  299. ---------------------------
  300. Below is an explanation of the action taken when a checkbox is _checked_.
  301.  
  302. **Auto-modify view:** check the modification date of the _text_file_ and modify the view if necessary. In order not to mix the two functions, this option is not in effect upon activation, until the text file is opened. (Again on purpose, this option does not activate auto-save)
  303.  
  304. **Include all files:** make sure that every text file in the folder is included in the view, by checking the folder modification date upon each activation.  (This was named auto-modify in the previous versions)
  305.  
  306. **Remove files not found:** check the folder modification date upon each activation, and remove files not found in the folder.
  307.  
  308. **Save after modifications:** save the view after any modification, manual or automatic.
  309.  
  310. **Private search string:** keep the search string for this view private.
  311.  
  312. Default preferences
  313. -------------------
  314. Default preferences can be setup in the Preferences dialog in two ways: when no view window is open or when the Clipboard is the active window.
  315.  
  316. All the view preferences has default values. 
  317.  
  318. Configuration
  319. -------------
  320. This dialog was added for configuring digest and mail formats.  (The dialog will appear if the option key was pressed when the Preferences menu is chosen) It is recommended that the beginners do not modify these strings. 
  321.  
  322. **Digest Data:** Strings that mark the beginning and the end of a digest are included. Chapter name is a bit tricky: it indicates the column numbers in the form of chars. It should be entered with ResEdit or similar utility.
  323.  
  324. **Mail Data:** The only string here is the one that separates various mail items. The remainder of the line is used as subject or sender, if either is missing.
  325.  
  326. **Section Name:** This set of buttons indicate how the sections are to be named.
  327.  
  328. Styles
  329. ------
  330. For each view, the information indicated below will be stored. This information will be written into the resource fork when the view is saved or closed, only if the user has modified the current values. This information will also be written when they are changed by the Styles dialog.
  331.  
  332. * Appearance of the normal text: font and size
  333. * Appearance of the lists: font, size, and justification
  334. * setext styles: used for emphasis and quotations
  335.  
  336. The user should press a radio button to select a particular style. The Font and Style menus, as well as the Type Face radio buttons, can be used for changing that style.
  337.  
  338. When the Styles dialog is not shown, Font and Size menus apply only on the normal text.
  339.  
  340.  
  341. Version history
  342. ===============
  343. Easy View was designed in 1990 in order to read Inside Macintosh more efficiently. Other formats were included in 1992.
  344.  
  345. Here is a summary of the growth of the application, beginning with version 2.0.
  346.  
  347. EV 2.0  July 92
  348. ---------------
  349. * New file format that allows longer chapter and section names
  350.  
  351. * Preferences are saved in the resource fork
  352.  
  353. * Defaults are saved in the Preferences file
  354.  
  355. * Movable Modal Dialogs are implemented
  356.  
  357. * Names are compared using IUEqualString, rather than string comparison
  358.  
  359. * Better parsing for setext and digest formats
  360.  
  361. * "Remove" button is added to the Modify dialog
  362.  
  363. EV 2.1  August 92
  364. -----------------
  365. * Finder aliases correctly open the original files
  366.  
  367. * Add/Remove routines rewritten
  368.  
  369. * Auto Modify is implemented
  370.  
  371. * "Last Position" is added to navigation menu
  372.  
  373. * File info is improved
  374.  
  375. EV 2.2  November 92
  376. -------------------
  377. * Digest format is made configurable
  378.  
  379. * Mail format is implemented
  380.  
  381. * Simple printing is enabled
  382.  
  383. * Panes are resizeable by mouse command 
  384.  
  385. * Font/Size menus are added for convenience
  386.  
  387. * "Set Bookmark" is added to navigation menu
  388.  
  389. * Clip and Copy operations are separated
  390.  
  391. * Custom SFGet and SFPut dialogs are used
  392.  
  393. EV 2.3  April 93
  394. ----------------
  395. * Apple event support: ability to open a text file with the correct application under System 7
  396.  
  397. * Filters generalize the concept of case-independent search: diacritical marks can be ignored, too
  398.  
  399. * "Search from top" option in Find dialog
  400.  
  401. * "Hide Top Window" command works very similar to the Hide command in the Application menu (Hidden window names are in italic)
  402.  
  403. * "Use Styles" menu toggles the use of styles. When something is copied while it is on, clipboard contents are also styled.
  404.  
  405. * Temporary memory is used for parsing under System 7, thus decreasing the minimum Finder partition
  406.  
  407. * When text is scrolled, an overlap with the previous window is retained
  408.  
  409. * "Print One" command is added for printing without a dialog
  410.  
  411. * "Display Selection" command makes navigation simplified
  412.  
  413. * The upper portion of a window is divided into two panes, rather than three. File Info is presented on the lower left corner (not optional)
  414.  
  415. * Menus are slightly rearranged
  416.  
  417. * Prefs dialog is greatly simplified. ~No more multiple modal dialogs~ "Auto modify", "Auto add", and "Auto remove" are separate options
  418.  
  419. * Modify menu: TAB key functional, "<<<" button for batch removal
  420.  
  421. * Clipboard is shown in default font/size
  422.  
  423. * Keypad does not change selection, it only scrolls
  424.  
  425. * Dialog names and behavior are made consistent
  426.  
  427. * Clip commands are enabled even when no clip file is open
  428.  
  429. * Pane sizes are adjusted on zoomed windows, if necessary 
  430.  
  431. * Mail format now displays the separator lines
  432.  
  433. * Empty Sender/Subject is properly handled
  434.  
  435. * Find window is not resized with changing font/size
  436.  
  437. * If a volume pointed by Finder aliases is off-line, it is recognized properly
  438.  
  439. EV 2.4  March 94
  440. ----------------
  441. * Large sections are broken into 32K-byte chunks (in any text format)
  442.  
  443. * A view can be saved as setext or as outline (with the option key)
  444.  
  445. * Text files can be included from the menu or by dragging into EV
  446.   (Such files are added to the active view)
  447.  
  448. * The backward/forward feature in a stack of 15 previous positions
  449.  
  450. * EV icon is colored slightly (may need to rebuild the Desktop)
  451.  
  452. * Last screen scrolls just enough to place the bottom line on top
  453.  
  454. * Copy/Clip operations are simplified: they apply on the selection, 
  455.   if any, on the entire section if none
  456.  
  457. * A finger cursor is displayed on clickable elements
  458.  
  459. * Clipped items are separated by CR's
  460.  
  461. * Command key is disabled with the arrows
  462.  
  463. * The infamous style bug is fixed
  464.  
  465. * The not-so-famous bug of empty files is fixed
  466.   (You cannot include empty text files any more)
  467.  
  468. * The unneeded items in SFPut dialog are removed
  469.  
  470.  
  471. Future directions
  472. =================
  473. Easy View is a program still under development. 
  474.  
  475. **User comments are welcome.**
  476.  
  477. Compatibility
  478. -------------
  479. Easy View will run under System 6.0 or later. The only reason why it will not work under earlier systems is its dependence on the Script Manager and styled TextEdit. It was tested with the Arabic system, and it should behave well with other scripts, too.
  480.  
  481. The performance is quite satisfactory even on a Mac Plus.
  482.  
  483. Easy View is compatible with System 7. It recognizes the Finder aliases and opens the original files.
  484.  
  485. Easy View 2.x file format
  486. -------------------------
  487. The view file contains three arrays in the data fork:
  488.  
  489.                 FILE, CHAP, SECT
  490.  
  491. Each array contains this record:
  492.         numRows: integer;
  493.         fRecLen, fRes0: integer;
  494.         nSize: longint;
  495.         maxSize: longint;
  496.         maxRows: integer;
  497.         hName: handle;
  498.         hData: handle;
  499.  
  500. The first 10 bytes are stored in the file as a header.
  501. (maxSize=nSize and maxRows=numRows, initially)
  502.  
  503. After the header, we have the contents of hData and hName, 
  504. in that order. (If a few bytes are missing at the end of 
  505. the file, the view is still readable)
  506.  
  507. The names are just added one after the other into hName^^.
  508. Here is the interpretation of hData^^ array:
  509.  
  510.     FileData = record
  511.         fName: longint;
  512.         fParser: integer;
  513.         fTime, fLength: longint;
  514.         fRes, fStatus: longint;    {Reserved}
  515.         end;
  516.  
  517.     ChapData = record
  518.         cName: longint;
  519.         cFile, cFirst, cNumber: integer;
  520.         cRes: longint;    {Reserved}
  521.         end;
  522.  
  523.     SectData = record
  524.         sName: longint;
  525.         sStart: longint;
  526.         sLength: integer;
  527.         end;
  528.  
  529. Each record starts with a long offset to the name handle.
  530. In effect, this is a variable-size array with variable-size
  531. strings. 
  532.  
  533. The resource fork contains the preferences in 'spec' 128 (110 bytes)
  534.         fRect: Rect;    {Window Rect}
  535.         sCurChap: integer;
  536.         sCurSect: integer;
  537.         fNumLines: integer; {Number of lines in the lists}
  538.         fChapPix: integer;
  539.         fSectPix: integer;
  540.         fFontT: FileStr;    {32 bytes}
  541.         fSizeT: integer;    {Display font size just}
  542.         fJustT: integer;
  543.         fFontL: FileStr;
  544.         fSizeL: integer;    {List font size just}
  545.         fJustL: integer;
  546.         fOptions: set of SpecOption; {2 bytes}
  547.         fSignature: OSType;
  548.         fFormat: integer;
  549.         fBookMark: IndexPosition;    {4 integers, EV 2.2}
  550.         fSpacing: integer;  {EV 2.3}
  551.         fFilter: integer;
  552.  
  553. Beginning with version 2.2, 'spec' 129 contains the configuration strings for mail and digest formats. (130 bytes)
  554.         fNameKind: integer;
  555.         fDigStart: FileStr;
  556.         fDigChap: FileStr;
  557.         fDigEnd: FileStr;
  558.         fMailStart: FileStr;
  559.         
  560. Also as of EV 2.2, 'PRNT' 128 contains the data related to printing. (120 bytes)
  561.  
  562. Beginning with version 2.3, 'spec' 130 contains the style information. (96 bytes)
  563.         fStArray: array[0..7] of TextStyle;
  564.  
  565. Not implemented yet
  566. -------------------
  567. Manual sorting of files within a view is a missing feature that would be quite useful. The current file format makes the reordering within a view rather difficult. This is why the order cannot be maintained upon auto-modification of a view.
  568.  
  569. Hypertext features such as annotations and links are coming next. This will enable the users to navigate better in the ever-growing information space.
  570.  
  571. Also considered are index views and bookmark views, as well as the automated maintenance of links between sections.
  572.  
  573. ..
  574.  
  575. Rather than opening this text file, you should directly open the view file "Easy View - Read Me" in order to appreciate the program.
  576.